home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 031a / pcal21.zip / WINPORT.TXT < prev   
Text File  |  1991-07-29  |  9KB  |  177 lines
  1.     WinPort - Portfolio functions for Mircrosoft Windows.
  2.  
  3.   WinPort is not a program in itself, but a nickname I gave to a 
  4. collection of programs I wrote to allow me to more easily acces my 
  5. Portfolio files from my Windows-based PC.  There are two programs 
  6. currently available, PortCard and PortCal.
  7.  
  8.   After using these two programs for a while, I quickly realized that 
  9. I was always using both of them for my scheduling.  I would enter 
  10. events into the calendar, then often I would enter more info into a 
  11. .ADR file that I was using as a To-Do list.  These two items (my 
  12. calendar and my to-do list) were separate, but had considerable 
  13. overlap.  I thought that it would be great if I could enter or view 
  14. an item in PortCal and be able to instantly find the corresponding 
  15. event (if any) in PortCard.  I began playing with the Windows DDE 
  16. support, and WinPort was born.
  17.  
  18.  WinPort is far from complete.  I am considering many new features.  
  19. However, is is very handy in its current state, and I would like 
  20. some feedback.  Please send me your suggestions and bug reports.
  21.  
  22.  Requirements:
  23.   Windows 3.0 or later
  24.   PortCal version 2.1 or later.
  25.   PortCard version 2.0 or later.
  26.   Address Book and Calendar files in the same directory and with the 
  27. same name. (For example, D:\SCHEDULE.CAL and D:\SCHEDULE.ADR.)
  28.  
  29.   A PC Card drive is recommended.
  30.  
  31.   Preparation:  The link requires files to have the same name.  If 
  32. you are already using the Address Book program and/or PortCard to 
  33. maintain a to-do list, copy it into the same directory as your
  34. calendar and rename it so that it has the same name (and an extension
  35. of .ADR).
  36.   If not, you should create one.  Use the Address book or PortCard to 
  37. create a new .ADR file.  Give it the same name as your schedule.  You 
  38. may also want to make the first card something like "AA@ My to-do 
  39. list".  (The "AA@" causes the card to always be first in the card 
  40. list.)  Save the file and exit PortCard.
  41.  
  42.   Start PortCal, and open your schedule.  Pull down the "Links" 
  43. menu, and select "Establish Link".  (If you started PortCal in such 
  44. a way that it auto-loaded a calendar, then PortCal will 
  45. automatically attempt to establish a link.)
  46.  
  47.   When PortCal tries to create a link with PortCard, it does the 
  48. following:
  49.   It makes a DDE call to all running applications to see if any will 
  50. give the proper response.  If there is a running copy of PortCard 
  51. that autoloaded a file with the same name, it will respond, and the 
  52. link will be established.  (Files opened by PortCard using the "Open 
  53. File" dialog box will NOT respond.)
  54.  
  55.   If no program responds, PortCal will look in the same directory as 
  56. its calendar for a file with the same name and an extension of .ADR.
  57. If found, it will launch PortCard, telling it to autoload the located
  58. file. The link will then be established.
  59.  
  60.   (All of that sounds pretty complicated, but it's really quite 
  61. simple.  Just keep your two files in the same directory, and let 
  62. PortCal do the work for you.)
  63.  
  64.   When the link is established, an extra checkbox labeled "Card" will 
  65. appear on the calendar.  This (and the items in the Links menu) are 
  66. the only indications that you have a link.
  67.  
  68.  At this point, PortCal is in control of PortCard.  You can still 
  69. control PortCard the way you always did, but for most things you 
  70. won't need to.  PortCal now has the following additional functions:
  71.  
  72.   Adding an event:  When you're adding an event, you can also check 
  73. the "Card" box.  When you enter your new event, it will be placed in
  74. the schedule as always.  In addition, it will enter a blank card into 
  75. PortCard, giving it an index the same as the event you just added.  
  76. It will also bring PortCard to the front so that you can enter text 
  77. on the card.
  78.   (If PortCard was "minimized", it will automatically be "restored" 
  79. for you.)
  80.  
  81.   Changing an entry.  When you double-click an entry in PortCal, It 
  82. will ask PortCard if there is a card with a matching index line.  If 
  83. there is, the "Card" checkbox will be checked for you.
  84.   If you turn off the checkbox, the card will automatically be 
  85. deleted.
  86.   If you turn on the checkbox for an entry that did not have a 
  87. corresponding card, the card will be created.
  88.   If you change an entry that has a corresponding card, the card's 
  89. index line will be changed to match.
  90.  
  91.   Deleting an entry - When you delete a calendar entry that has a 
  92. corresponding card, the card will be deleted.
  93.  
  94.   Viewing a card - Of course, you could bring Portcard to the front 
  95. and use it as you normally do.  Also, you could...
  96.   Click on an entry in PortCal.  Pull down the Links menu.  If the 
  97. item you selected has a matching card, the Show Card item will be 
  98. enabled.  Selecting Show Card will bring PortCard to the front, and 
  99. display the matching card.
  100.  
  101.   As before, when you single-click on a headline or event, a small
  102. square will appear to the left of the headline box or event box, and
  103. you can drag the box onto the calendar window to move or copy the event.
  104. When a link is established, the box is also a visual indicator.  If there
  105. is no card associated with the event, the box will be hollow (i.e., have
  106. a grey interior).  If there is a card associated with the event or headline,
  107. the box will be filled (i.e., have a black interior).
  108.  
  109.   As usual, if you are creating a new event or are making changes to an
  110. existing event, the right mouse button will end the editing of the event.
  111. This is still true when a link is established.  However, if you are not
  112. creating or changing an event, clicking the right mouse button will behave
  113. the same as if you selected Show Card from the Links menu.  (I.e. it will
  114. show the card associated with the highlighted event if one exists.)
  115.  
  116.   Selecting Refresh, Save, or Exit from PortCal will operate PortCal 
  117. and PortCard, causing the action to occur in both applications.
  118.  
  119.   Selecting New or Open from PortCal will terminate the link.
  120.  
  121.   Whenever PortCal askes you to "Save Changes?", your answer will 
  122. affect both applications.
  123.  
  124.   When an Alarm goes off, there will be two buttons in the Alarm window
  125. labeled OK and Card.  The Card button will be greyed out if there is no
  126. card associated with that Alarm.  Clicking on Card will dismiss the Alarm
  127. (as will OK), but the Card button will also bring PortCard to the front
  128. and display the card associated with that Alarm.  (If no link is
  129. established, the Card button will not be present.)
  130.  
  131.   You can destroy the link between PortCal and PortCard by selecting 
  132. "Close Link" from the Links menu.  Any DDE error (such as a DDE timeout)
  133. will also close the link.
  134.   When the link is closed, the PortCal and PortCard operate as two separate
  135. applications.  If you closed the link by mistake, or it was closed due
  136. to a DDE error, you can simply select Establish Link from the Links menu
  137. again.
  138.  
  139.  
  140.   A few notes:
  141.   There is no "magic" connection between a calendar event and a card.  
  142. Matches are made simply by comparing the event text with the index line
  143. on the card.  This has the following caveats:
  144.   If you add two events with the same description, two cards will be 
  145. created.  Selecting, changing, or deleting either event in the 
  146. calendar will cause the first card to be affected.
  147.  
  148.   In this version of WinPort, PortCal can control certain aspects of
  149. PortCard, but not vice-versa.  This means, for example, that if you do
  150. a save from PortCard, PortCal will NOT be saved as well.  If you use
  151. PortCard to change a card's Index, it will NOT cause a corresponding
  152. change to the calendar.  For that reason, you should always use PortCal
  153. when you want to control both applications.
  154.  
  155.   Also:
  156.   PortCal will only prompt you to Save Changes if the calendar is 
  157. "dirty".  Therefore, if you change a card, but not the calendar, then 
  158. select Exit from the calendar, your card changes will be lost.  (This 
  159. will be remedied in a future release.)
  160.  
  161.  PortCal will establish a link with one "instance" of PortCard.  You 
  162. can have multiple copies of PortCard running at the same time.  
  163. PortCal will only control one of them.
  164.  
  165.   If you have both applictions running when you Exit Windows, Windows
  166. tells each application to shut down, in turn.  If PortCard shuts down
  167. first, you may receive a message from PortCal saying the the link to 
  168. PortCard has been closed.  Also, depending on the order that Windows
  169. shuts down programs, you will get zero, one, or two questions, asking
  170. you to "Save Changes?".  As long as you always answer "Yes", you should
  171. have no problems.
  172.  
  173.  
  174.   That's about it.  Play with it, try it, experiment with it.  It's 
  175. actually easier to use than it is to describe.  Please send me your 
  176. comments and suggstions.
  177.